home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / tsmenu29.arc / TSMENU.DOC next >
Text File  |  1987-02-01  |  34KB  |  727 lines

  1.  
  2.  
  3.      TSMENU  Ver. 2.9                                                    Page  1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.      TTTTTTTTTT    SSSSSSS   M          M  EEEEEEEEEE  NN      NN  UU        UU
  17.          TT      SS          MM        MM  EE          NNNN    NN  UU        UU
  18.          TT      SS          MMM     MMMM  EE          NN NN   NN  UU        UU
  19.          TT        SSSSSS    MMMM   MM MM  EEEEEEEE    NN  NN  NN  UU        UU
  20.          TT              SS  MM MM MM  MM  EE          NN   NN NN  UU        UU
  21.          TT              SS  MM  MMM   MM  EE          NN    NNNN  UU        UU
  22.          TT       SSSSSSS    MM   M    MM  EEEEEEEEEE  NN      NN    UUUUUUUU
  23.  
  24.  
  25.  
  26.  
  27.  
  28.      TSMENU - A Versatile PC Menu System.  . . . . . . . . . . . . . . . . .   2
  29.  
  30.      SHAREWARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  31.  
  32.      WHAT MAKES UP TSMENU  . . . . . . . . . . . . . . . . . . . . . . . . .   3
  33.  
  34.      WHAT IS A MENU  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  35.  
  36.      MAINTAINING THE MAIN SYSTEM MENU  . . . . . . . . . . . . . . . . . . .   4
  37.           ADDING A NEW MENU SELECTION  . . . . . . . . . . . . . . . . . . .   4
  38.           CHANGING A MENU SELECTION  . . . . . . . . . . . . . . . . . . . .   5
  39.                Adding a command line . . . . . . . . . . . . . . . . . . . .   6
  40.                Inserting a command line  . . . . . . . . . . . . . . . . . .   6
  41.                Changing a command line . . . . . . . . . . . . . . . . . . .   7
  42.                Deleting a command line . . . . . . . . . . . . . . . . . . .   7
  43.                Changing the selection description  . . . . . . . . . . . . .   7
  44.                Changing the selection directory  . . . . . . . . . . . . . .   8
  45.                Ending the selection change process . . . . . . . . . . . . .   8
  46.           DELETING A MENU SELECTION  . . . . . . . . . . . . . . . . . . . .   8
  47.           SAVING THE NEW MENU  . . . . . . . . . . . . . . . . . . . . . . .   8
  48.           CANCELING MENU FILE MAINTENANCE  . . . . . . . . . . . . . . . . .   9
  49.           CREATING AND MAINTAINING SUB-MENUS . . . . . . . . . . . . . . . .   9
  50.  
  51.      CHANGING THE MENU FIRST TITLE LINE  . . . . . . . . . . . . . . . . . .  10
  52.  
  53.      SAMPLE MENU ENTRIES . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  64.  
  65.  
  66.  
  67.  
  68.  
  69.      TSMENU  Ver. 2.9                                                    Page  2
  70.  
  71.                         TSMENU - A Versatile PC Menu System.
  72.  
  73.      TSMENU will  allow you  to set up menus and sub-menus to get to all of your
  74.      software packages without remembering  the  complicated  command  names and
  75.      directory pathnames.  Once an application has been set up under TSMENU, all
  76.      that is required to access the application is  to select  the proper number
  77.      from a menu.  TSMENU will handle up to 30 menu selections per menu, and the
  78.      number of sub-menus is limited only by the number of directories and/or the
  79.      available  disk  space.    The  display of menu selections is automatically
  80.      adjusted according to the number of selections on a menu from double spaced
  81.      single column  to single  spaced double column display.  TSMENU is designed
  82.      for hard disk users, but will work on floppy systems as well.
  83.  
  84.                                       SHAREWARE
  85.  
  86.      This is a shareware program package. The existence of such software depends
  87.      upon the honesty and integrity of user's.  I know that a lot of people will
  88.      use this package with  no  payment  to  me  and  not  one  twinge  of their
  89.      conscience.  I feel that most of those people would obtain the software and
  90.      use it even if it was sold in  stores  in  a  neat  package  and  even (God
  91.      forbid) if  it was copy protected.  This software was not written for them.
  92.      It was written for those user's  which have  a need  for a  menu system and
  93.      recognize a  good value  and are willing to pay a reasonable price for that
  94.      value.  So, here are the rules:
  95.  
  96.           You may copy and distribute this program freely, provided that:
  97.           1.   No fee is charged for such copying and distribution, and
  98.           2.   It is distributed ONLY in its original, unmodified state.
  99.  
  100.           This product is NOT free.  If you  use it  you must  pay whatever
  101.           you think it is worth to you.
  102.  
  103.      The  suggested  contribution  for  TSMENU  is  $20.  This contribution will
  104.      entitle you to become  a registered  user.   As a  registered user  you are
  105.      entitled to:
  106.  
  107.           1.   Call or write for help in using the product.
  108.           2.   Receive free  updates to the product (you pay only for the medium
  109.                and postage).
  110.           3.   Receive free notice of new programs as they are released.
  111.  
  112.      You may not use this product in a commercial environment  or a governmental
  113.      organization  without  paying  a  license  fee  of  $20.  Site licenses and
  114.      commercial distribution licenses are available.
  115.  
  116.      If you wish to register as a user, please send  your check,  name, address,
  117.      and phone number to the address below.
  118.  
  119.      Address all correspondence to:     Dick Whiteley
  120.                                         BearWare Systems
  121.                                         P.O. Box 506
  122.                                         Joelton, TN 37080
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  130.  
  131.  
  132.  
  133.  
  134.  
  135.      TSMENU  Ver. 2.9                                                    Page  3
  136.  
  137.           WHAT MAKES UP TSMENU
  138.  
  139.      TSMENU consists of the following:
  140.  
  141.       1. TSMENUFM.EXE - The Menu Maintenance program        * 
  142.       2. TSMENUDS.COM - The Menu Display Program            *
  143.       3. TSMENU.BAT   - The Menu batch file
  144.       4. TSMENU.OPT   - The Menu Control file               *
  145.       5. TSMENU.SCR   - The Menu Screen file
  146.       6. 1...30.BAT   - The Menu Selection file(s)
  147.  
  148.                * - These files are provided in the distribution package.
  149.                    The others will be created when TSMENUFM is executed.
  150.  
  151.      NOTES:
  152.             1. TSMENUFM.EXE and  TSMENUDS.COM should  be located  in a directory
  153.                which has a "PATH" specified in the autoexec.bat file.
  154.  
  155.             2. TSMENU.OPT and TSMENU.SCR must remain in  the root  directory for
  156.                the main  menu.   There will be another copy (different) of these
  157.                files in each directory which has a sub-menu within it.
  158.  
  159.             3. TSMENU.BAT,  TSMENU.OPT,  TSMENU.SCR,  and  the  files  1.BAT ...
  160.                30.BAT  will  be  re-written  each  time the menu is updated with
  161.                TSMENUFM. 
  162.  
  163.           WHAT IS A MENU
  164.  
  165.      A menu consists of a menu screen file named "TSMENU.SCR", and a  batch file
  166.      for  each  selection  on  the  menu  (e.g.  "1.BAT").   The TSMENU.SCR file
  167.      contains the screen image of the menu in a Basic "BSAVE" format.  Each menu
  168.      selection consists  of a  batch file  to call  the desired application. The
  169.      batch files are named 1.BAT, 2.BAT, 3.BAT, ,,, 30.BAT; corresponding to the
  170.      selections on  the menu,  thus to  select a function the user merely enters
  171.      the number of the function and presses the Enter key.  Each  batch file has
  172.      certain commands  at the first of it to turn echo off, set standard prompt,
  173.      and  change  the  current  directory  to  the  desired  directory  for  the
  174.      application, and  at the  end of  the file to change the directory back and
  175.      recall the menu screen.  In between  theses commands  are whatever commands
  176.      and batch  statements the  user inserts to execute the desired application.
  177.      A menu may contain up to 30 selections, and each  selection may  contain up
  178.      to  50  batch  statements  to  perform  the  desired  applications.  A menu
  179.      selection may call another menu in a sub-directory  which has  it's own set
  180.      of files  and functions,  thus allowing an unlimited number of functions to
  181.      be under menu selection.
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  196.  
  197.  
  198.  
  199.  
  200.  
  201.      TSMENU  Ver. 2.9                                                    Page  4
  202.  
  203.           MAINTAINING THE MAIN SYSTEM MENU
  204.  
  205.      The Main System Menu is  generated  by  TSMENUFM.EXE  using  a  file called
  206.      "TSMENU.OPT" which  is created at installation time and updated by the user
  207.      as desired using TSMENUFM. For assistance in entering commands to make up a
  208.      menu selection  refer to  the "Batch" section of your DOS manual.  The Menu
  209.      File Maintenance Program updates the "TSMENU.OPT"  file and  re-creates the
  210.      menu files  when changes  are made.  This program  provides the facility to
  211.      make changes to the Main System  Menu, and  to create  and maintain various
  212.      sub-menus.   The user may add, change, or delete menu selections on a menu,
  213.      create new menus, and  change  menu  titles.    No  provision  is  made for
  214.      deleting complete menus.  This must be done using DOS commands. To run this
  215.      program, from the Root Directory enter TSMENUFM followed by Enter.
  216.  
  217.      The program will first ask:
  218.  
  219.           Do you wish to work with the Main System Menu? (Y/N)          Do you wish to work with the Main System Menu? (Y/N)                         
  220.  
  221.      Press the "Y" key to allow changes to be made to the Main System Menu.  The
  222.      program will then display the message:
  223.  
  224.                               READING OPTION FILE                              READING OPTION FILE
  225.  
  226.  
  227.      After a  short delay  the menu  screen will be displayed with the following
  228.      prompts at the bottom of the screen:
  229.                       Press key in () for option desired                      Press key in () for option desired
  230.                          
  231.          (A)dd selection     (C)hange selection     (D)elete selection         (A)dd selection     (C)hange selection     (D)elete selection
  232.                          
  233.          (S)ave new menu     (Q)uit - don't save    (T)o change colors         (S)ave new menu     (Q)uit - don't save    (T)o change colors
  234.  
  235.      The previous screen display will be  referred  to  as  Screen  1.    At the
  236.      completion  of  any  function,  the  program  will  return to Screen 1.  On
  237.      occasion, when returning to Screen 1, the program  will display  a flashing
  238.      message "Please  Wait" on the screen for 2-5 seconds.  This will only occur
  239.      if several changes have been made, and is caused by some "housekeeping" the
  240.      program must do. The remainder of this section will concern itself with the
  241.  
  242.      six options displayed on Screen 1.  First is the  Add option  which will be
  243.      used to add a selection for Menu File Maintenance itself.
  244.  
  245.           ADDING A NEW MENU SELECTION
  246.  
  247.      To add a selection to the end of a menu, simply press the "A" key at Screen
  248.      1.  The following screen will be displayed with the menu title at the top:
  249.  
  250.                                   Add new selection                                  Add new selection
  251.                          
  252.               Enter Selection description for menu display :              Enter Selection description for menu display :
  253.  
  254.      The line (up to 33 characters) which will be displayed on the menu for this
  255.      selection will  be entered  here.   For our  example to add a selection for
  256.      Menu File Maintenance, enter the following:
  257.  
  258.           Menu File Maintenance
  259.  
  260.  
  261.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  262.  
  263.  
  264.  
  265.  
  266.  
  267.      TSMENU  Ver. 2.9                                                    Page  5
  268.  
  269.  
  270.      Followed by the Enter key.  The following prompt will be displayed:
  271.  
  272.               Enter Directory for new selection              Enter Directory for new selection
  273.               (Press <Enter> alone for root Directory)              (Press <Enter> alone for root Directory)
  274.               Directory name = :              Directory name = :
  275.  
  276.      The Directory pathname for  the this  selection will  be entered  here. All
  277.      menu selections  contain a  "CD" command  prior to any other command lines.
  278.      If it is necessary to change the directory again within the selection, "CD"
  279.      commands may  be entered on command lines.  For our example, just press the
  280.      Enter key, as the Menu File Maintenance program must always be run from the
  281.      root Directory.  The following prompt will be displayed:
  282.  
  283.               Press <Enter> alone at command entry to end selection.              Press <Enter> alone at command entry to end selection.
  284.               Enter command line 1  :              Enter command line 1  :
  285.  
  286.      The batch  commands to perform the desired function for this menu selection
  287.      may now be entered one per line followed by the Enter key.  After each line
  288.      is entered,  a new "Enter command line x  :" prompt will be displayed where                         Enter command line x  :
  289.      "x" is the number of the next command line.  After all necessary lines have
  290.      been entered,  press the  Enter key  again and  the program  will return to
  291.      Screen 1 with the new menu selection added to the menu.
  292.  
  293.      For our example, enter the following for command line 1:
  294.  
  295.           TSNENUFM
  296.  
  297.      followed by the Enter key.  This entry is incorrect, but we will correct it
  298.      below in  the following  section.   Press the Enter key again at the prompt
  299.      for command line 2 and the program will return to Screen 1.  This completes
  300.      the Add function.
  301.  
  302.           CHANGING A MENU SELECTION
  303.  
  304.      To  change  an  existing  menu  selection  (including one just added), from
  305.      Screen 1 press the "C" key.  The following prompts will be displayed at the
  306.      bottom of the screen:
  307.  
  308.          (Enter 0 to abort change function, enter 98 to change menu Title)         (Enter 0 to abort change function, enter 98 to change menu Title)
  309.                    Enter selection no. to change :                   Enter selection no. to change :
  310.  
  311.      To change  an existing  menu selection, enter the number listed on the menu
  312.      for that selection followed by the enter key. To change  the menu  title at
  313.      the top of the menu, enter 98 followed by the Enter key, then enter the new
  314.      title followed by the Enter key, and the  program will  return to  Screen 1
  315.      with the  new title.  If you pressed the "C" key by mistake, enter 0 (zero)
  316.      followed by the enter key and the program will return to Screen  1. For our
  317.      example, enter  the number of the Menu File Maintenance selection and press
  318.      the Enter key. The following screen will appear, which will  be referred to
  319.      as Screen 2:
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  328.  
  329.  
  330.  
  331.  
  332.  
  333.      TSMENU  Ver. 2.9                                                    Page  6
  334.  
  335.                              Change menu selection                             Change menu selection
  336.                          
  337.          Selection no. nn, Description = Menu File Maintenance         Selection no. nn, Description = Menu File Maintenance
  338.                          
  339.          Directory = \          Directory = \ 
  340.                          
  341.          Command line  1 = TSNENUFM         Command line  1 = TSNENUFM
  342.               .              .
  343.               .              .
  344.               .              .
  345.      Press character in () to select option or Press <Enter> alone to end change     Press character in () to select option or Press <Enter> alone to end change
  346.                          
  347.      (A)dd  command  (I)nsert  command  (C)hange  command (D)elete command (N)ew     (A)dd  command  (I)nsert  command  (C)hange  command (D)elete command (N)ew
  348.      desc.     desc.
  349.                          
  350.               (\)directory change   page (F)orward   page (B)ackward              (\)directory change   page (F)orward   page (B)ackward
  351.  
  352.      Where "nn" is the  number of  the menu  selection chosen  from the previous
  353.      prompt.    In  most  cases  the  entire menu selection will be displayed on
  354.      Screen 2 as in our example and the  "page (F)orward"  and "page (B)ackward"
  355.      prompts will  not appear.  However if there are more than 10 command lines,
  356.      only the first 10  lines will  be displayed,  and the  "page (F)orward" and
  357.      "page (B)ackward"  prompts will  appear.  In this case the "F" and "B" keys
  358.      may be used to view the entire  selection,  10  command  lines  at  a time.
  359.      Prior to  making a  change which  will affect  a command line, that command
  360.      line must be on the displayed  screen.   The remaining  six options  are as
  361.      follows:
  362.  
  363.                     Adding a command line
  364.  
  365.           To add  a new  command line to the end of the selection, from Screen 2
  366.           press the "A" key and the following prompts  will be  displayed at the
  367.           bottom of the screen:
  368.  
  369.                     New line to be added after line no. nn                    New line to be added after line no. nn                         
  370.                          
  371.                                              Command line =                    Command line =                         
  372.  
  373.           Where "nn"  will be  a number  one higher  than the  last command line
  374.           currently in the selection.  At this point, enter the new command line
  375.           to be  added followed  by the Enter key and the program will return to
  376.           Screen 2.
  377.  
  378.                     Inserting a command line
  379.  
  380.           To insert a new  command line  before an  existing command  line, from
  381.           Screen 2 press the "I" key and the following prompts will be displayed
  382.           at the bottom of the screen:
  383.  
  384.                     Press <Enter> alone to return to change options.                    Press <Enter> alone to return to change options.                         
  385.                          
  386.                                              Enter command line no. to insert new line before :                    Enter command line no. to insert new line before :                         
  387.  
  388.           Enter the line number following  where  you  wish  to  insert  the new
  389.           command line  and press  the Enter key, or press the Enter key only to
  390.           return to Screen 2. If you entered a line number, the following prompt
  391.  
  392.  
  393.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  394.  
  395.  
  396.  
  397.  
  398.  
  399.      TSMENU  Ver. 2.9                                                    Page  7
  400.  
  401.           will be displayed at the bottom of the screen:
  402.  
  403.                         New line to be inserted before line no. nn                        New line to be inserted before line no. nn
  404.                          
  405.                                             Command line =                   Command line =                         
  406.  
  407.           The new command line may now be entered, followed by the Enter key and
  408.           the program will return to Screen 2.
  409.  
  410.                     Changing a command line
  411.  
  412.           To change an existing command line,  from Screen  2 press  the "C" key
  413.           and  the  following  prompts  will  be  displayed at the bottom of the
  414.           screen:
  415.  
  416.                     Press <Enter> alone to return to change options.                    Press <Enter> alone to return to change options.                         
  417.                          
  418.                                              Enter command line no. to change :                    Enter command line no. to change :                         
  419.  
  420.           Enter the line number of the command line you wish to change and press
  421.           the Enter  key, or  press the Enter key only to return to Screen 2. If
  422.           you entered a line number, the command line  selected will  be blanked
  423.           out on  the screen  and the cursor will be positioned at the beginning
  424.           of that  command  line.  The  new  command  line  may  now  be entered
  425.           followed by the Enter key and the program will return to Screen 2. For
  426.           our example, we wish to correct  command line  number 1,  so enter "1"
  427.           followed by the Enter key, then enter the following:
  428.  
  429.               TSMENUFM
  430.  
  431.           followed by the Enter key. The program will now return to Screen 2.
  432.  
  433.                     Deleting a command line
  434.  
  435.           To delete  an existing  command line,  from Screen 2 press the "D" key
  436.           and the following prompts will  be  displayed  at  the  bottom  of the
  437.           screen:
  438.  
  439.                     Press <Enter> alone to return to change options.                    Press <Enter> alone to return to change options.                         
  440.                          
  441.                                              Enter command line no. to delete :                    Enter command line no. to delete :                         
  442.  
  443.           Enter the line number of the command line you wish to delete and press
  444.           the Enter key, or press the Enter key only to  return to  Screen 2. If
  445.           you entered  a line  number, the command line selected will be deleted
  446.           from the selection and the program will return to Screen 2.
  447.  
  448.                     Changing the selection description
  449.  
  450.           To change the description  (the  text  to  be  displayed  on  the menu
  451.           screen) of  the selection,  from Screen  2 press  the "N"  key and the
  452.           following prompts will be displayed at the bottom of the screen:
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  460.  
  461.  
  462.  
  463.  
  464.  
  465.      TSMENU  Ver. 2.9                                                    Page  8
  466.  
  467.                     Press <Enter> alone to leave unchanged                    Press <Enter> alone to leave unchanged                         
  468.                          
  469.                                              Enter new description :                    Enter new description :                         
  470.  
  471.           Enter the new description (up to 33 characters) followed by  the Enter
  472.           key, or  press the  Enter key only to leave the description unchanged.
  473.           In either case, the program will return to Screen 2.
  474.  
  475.                     Changing the selection directory
  476.  
  477.           All menu selections automatically contain a "CD" command  prior to any
  478.           other command  lines, the  directory for which is entered here.  If it
  479.           is necessary to change the directory again within  the selection, "CD"
  480.           commands  may  be  entered  on  command  lines.  To change the initial
  481.           selected directory for the menu selection, from Screen 2 press the "\"
  482.           key and  the following  prompts will be displayed at the bottom of the
  483.           screen:
  484.  
  485.          Enter 'MAIN' for root directory, <Enter> alone to leave unchanged         Enter 'MAIN' for root directory, <Enter> alone to leave unchanged
  486.                          
  487.               Enter new directory :              Enter new directory :
  488.  
  489.      Enter the new directory pathname followed  by the  Enter key,  or press the
  490.      Enter key  only to  leave the directory pathname unchanged. In either case,
  491.      the program will return to Screen 2.
  492.  
  493.                     Ending the selection change process
  494.  
  495.           Once all changes have  been made  to a  menu selection,  from Screen 2
  496.           press the  Enter key  and the  program will  return to  Screen 1. This
  497.           completes the discussion of selection change options. 
  498.  
  499.           DELETING A MENU SELECTION
  500.  
  501.      To delete a menu selection from the menu,  press the  "D" key  at Screen 1,
  502.      and the following prompts will be displayed at the bottom of the screen:
  503.  
  504.                         (Enter 0 to abort delete function)                        (Enter 0 to abort delete function)
  505.                          
  506.                         Enter selection no. to delete :                        Enter selection no. to delete :
  507.  
  508.      Enter the  number listed  for the  selection you wish to delete followed by
  509.      the Enter key and the program  will  delete  the  selection  and  return to
  510.      Screen 1.  If you  wish to return to Screen 1 without deleting a selection,
  511.      just press the Enter key.
  512.  
  513.           SAVING THE NEW MENU
  514.  
  515.      To save the new menu with the changes made, from Screen 1 press the "S" key
  516.      and the program will display the following while it creates a new menu:
  517.  
  518.                         Creating 'xxx...xxx' Menu                        Creating 'xxx...xxx' Menu
  519.  
  520.      where "xxx...xxx'  will be  replaced by  the menu  title.   There will be a
  521.      short delay while the program creates all the files for the menu,  then the
  522.      menu screen  will be  displayed and the program will terminate.  If this is
  523.  
  524.  
  525.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  526.  
  527.  
  528.  
  529.  
  530.  
  531.      TSMENU  Ver. 2.9                                                    Page  9
  532.  
  533.      the first time Menu File Maintenance is run the system  will return  to the
  534.      C> prompt.   If  Menu File Maintenance has been run from the menu selection
  535.      created as directed in this section, the system  should return  to the main
  536.      menu.
  537.  
  538.           CANCELING MENU FILE MAINTENANCE
  539.  
  540.      If you  wish to cancel Menu File Maintenance and not save any changes, from
  541.      Screen 1 press the "Q" key and the program will immediately terminate.  All
  542.      menu files will be left as before.
  543.  
  544.           CREATING AND MAINTAINING SUB-MENUS
  545.  
  546.      Menu File  Maintenance will allow the creation and maintenance of sub-menus
  547.      in Directories.  Sub-menus may not be created in the root Directory  due to
  548.      file naming  conflicts.   Menu maintenance on sub-menus differs very little
  549.      from that of the main menu.  The following outlines those differences.
  550.  
  551.  
  552.      To enter sub-menu maintenance, run the  Menu File  Maintenance program, and
  553.      when the first prompt:
  554.  
  555.               Do you wish to work with the Main System Menu? (Y/N)              Do you wish to work with the Main System Menu? (Y/N)
  556.  
  557.      appears, press the "N" key and the following prompt will be displayed:
  558.  
  559.               Enter Filename for Submenu (Press <Enter> to use 'TSMENU') :              Enter Filename for Submenu (Press <Enter> to use 'TSMENU') :
  560.  
  561.      This prompt  is for  the filename  of the menu batch file.  It is suggested
  562.      that you press the Enter key to use the default name, however you may enter
  563.      a 1-8  character filename here if desired. The only place this name will be
  564.      used is here and in the main menu  if you  enter a  selection to  call this
  565.      sub-menu.   There will be no conflict with the Main System Menu name, since
  566.      the next prompt will force you to place this menu in a Directory:
  567.  
  568.               Enter Directory name for Submenu :              Enter Directory name for Submenu :
  569.  
  570.      The Directory pathname must be entered here.    This  is  the  name  of the
  571.      Directory where the sub-menu will be created or updated.  It may not be the
  572.      root directory.  At this point the program will proceed the same  as if you
  573.      had  selected  the  Main  System  menu,  except  you will be working with a
  574.      sub-menu in a Directory.   When  a sub-menu  is first  created, the program
  575.      will automatically  create a  menu selection  to return  to the Main System
  576.      Menu, then proceed to Screen 1.
  577.  
  578.      The only other difference for a sub-menu is that when you are  prompted for
  579.      a directory  for a  sub-menu selection,  the program will give an option to
  580.      press the Enter  key  to  select  the  same  Directory  which  contains the
  581.      sub-menu,  or  enter  'MAIN'  to  select  the  root  Directory.    All menu
  582.      selections contain a "CD" command prior to any other command lines.   If it
  583.      is  necessary  to  change  the  Directory  again within the selection, "CD"
  584.      commands may be entered on command lines.
  585.  
  586.      Once you have created a sub-menu,  you should  enter Menu  File Maintenance
  587.      again  using  the  Main  System  Menu  and enter a selection to call up the
  588.      sub-menu. This selection should  be  entered  by  specifying  the Directory
  589.  
  590.  
  591.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  592.  
  593.  
  594.  
  595.  
  596.  
  597.      TSMENU  Ver. 2.9                                                   Page  10
  598.  
  599.      pathname of  the sub-menu  for the  Directory entry,  and "TSMENU" (default
  600.      menu name), or whatever file name you specified when creating the sub-menu,
  601.      for command line 1. You will then be able to switch between the Main System
  602.      Menu and the sub-menu by selecting menu items from each menu.
  603.  
  604.           CHANGING THE MENU FIRST TITLE LINE
  605.  
  606.      The first line of the menu title will always be "TSMENU" unless  you change
  607.      it  using  this  procedure.  This  line  may not be changed by the TSMENUFM
  608.      program.  To change the line, edit the  file TSMENU.OPT  with your favorite
  609.      ASCII editor,  and insert  a new  line as the first line of the file.  This
  610.      new line must have a capitol "C" as  the first  character of  the line; the
  611.      remainder of the line will appear on the first title line of the menu. Save
  612.      the file and run TSMENUFM and  save  the  menu  to  have  this  change take
  613.      effect.
  614.  
  615.           SAMPLE MENU ENTRIES
  616.  
  617.      Having read  this far,  it may  now be clear how to use TSMENUFM, but quite
  618.      unclear what to input for  your  menu  entries.  In  the  case  where there
  619.      already exists a batch file to call your application, simply TYPE the batch
  620.      file, make a note of the commands, then enter these commands into TSMENUFM,
  621.      keeping in  mind that  TSMENU provides  the Change Directory command at the
  622.      start of the file and it will return  you to  the menu  directory after the
  623.      application has  finished. For example, I had a batch file called LEARN.BAT
  624.      which called WordPerfect using the  WORDP\LEARN  directory  for  data which
  625.      looked like this:
  626.  
  627.           CD \WORDP\LEARN
  628.           WP /R
  629.           CD \
  630.  
  631.      To change this to use TSMENU, the following entry was added using TSMENUFM:
  632.  
  633.       Selection no. 4, Description = Word Perfect Learning      Selection no. 4, Description =
  634.  
  635.       Directory = WORDP\LEARN      Directory = 
  636.  
  637.       Command line  1 = WP /R      Command line  1 = 
  638.  
  639.      I then  deleted the file LEARN.BAT, and used the menu selection no. to call
  640.      WordPerfect. Most menu entries will be as simple as this  one, with  only a
  641.      directory  change,  and  a  one-line  command.  Most  Spreadsheets,    Word
  642.      Processors, and Graphic programs will require only the single command line.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  658.  
  659.  
  660.  
  661.  
  662.  
  663.      TSMENU  Ver. 2.9                                                   Page  11
  664.  
  665.      A more complicated example is the one I  use for  Cornerstone, a relational
  666.      database package.  Here the command which actually calls the application is
  667.      "MME [/ext] database". The complete TSMENU entry is as follows:
  668.  
  669.       Selection no. 9, Description = Cornerstone      Selection no. 9, Description = 
  670.                                
  671.       Directory = \CORNER                                                             Directory = 
  672.                             
  673.      Command line  1 = unkey           Command line  1 = 
  674.      Command line  2 = if %1x==x goto default           Command line  2 =
  675.      Command line  3 = if %2x==x goto doit           Command line  3 = 
  676.      Command line  4 = mme /e%2 %1           Command line  4 =
  677.      Command line  5 = goto end           Command line  5 = 
  678.      Command line  6 = :doit           Command line  6 = 
  679.      Command line  7 = mme %1           Command line  7 = 
  680.      Command line  8 = goto end           Command line  8 =
  681.      Command line  9 = :default           Command line  9 = 
  682.      Command line 10 = MME SAMPLE           Command line 10 =
  683.      Command line 11 = :end      Command line 11 = 
  684.      Command line 12 = KEYS     Command line 12 =
  685.  
  686.      The understanding  of this  entry will  require some knowledge of DOS Batch
  687.      language.  The line-by-line explanation  is  as  follows:  1)  disables the
  688.      custom function keys which I use; 2) tests for a database name and if there
  689.      is none, goes to line 9 which calls up the default database; 3) tests for a
  690.      second parameter  and if  there is  none, goes to line 6 which calls up the
  691.      specified data base; 4)  calls up  the specified  database with  the second
  692.      parameter passed  with a  "/e" prefix; 5) goes to line 11 to exit after the
  693.      database work is complete; 6) is a  tag  for  branching;  7)  calls  up the
  694.      specified database;  8) goes  to line 11 to exit after the database work is
  695.      complete; 9) is a tag for branching; 10) calls up the default database; 11)
  696.      is a tag for branching; and 12) re-instates the custom function keys.
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                  TSMENU     (c) Copyright 1986, 1987  Dick Whiteley
  724.  
  725.  
  726.  
  727.